home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / f90 / associated.z / associated
Encoding:
Text File  |  2002-10-03  |  2.8 KB  |  69 lines
  1. ASSOCIATED(3I)                                        Last changed: 4-13-99
  2.  
  3.  
  4. NNAAMMEE
  5.      AASSSSOOCCIIAATTEEDD - Returns the pointer association status
  6.  
  7. SSYYNNOOPPSSIISS
  8.      AASSSSOOCCIIAATTEEDD (([PPOOIINNTTEERR==]_p_o_i_n_t_e_r [,,[TTAARRGGEETT==]_t_a_r_g_e_t]))
  9.  
  10. IIMMPPLLEEMMEENNTTAATTIIOONN
  11.      UNICOS, UNICOS/mk, IRIX systems
  12.  
  13.      CF90, MIPSpro 7 Fortran 90
  14.  
  15. SSTTAANNDDAARRDDSS
  16.      Fortran
  17.  
  18. DDEESSCCRRIIPPTTIIOONN
  19.      The AASSSSOOCCIIAATTEEDD intrinsic function returns the association status of
  20.      its pointer argument or indicates the pointer is associated with the
  21.      target.  It accepts the following arguments:
  22.  
  23.      _p_o_i_n_t_e_r   Must be a pointer and can be of any type.  Its pointer
  24.                association status must not be undefined.
  25.  
  26.      _t_a_r_g_e_t    Must be a pointer or target.  If it is a pointer, its
  27.                pointer association status must not be undefined.
  28.  
  29.      AASSSSOOCCIIAATTEEDD is an inquiry function.  The name of this intrinsic cannot
  30.      be passed as an argument.
  31.  
  32. RREETTUURRNN VVAALLUUEESS
  33.      The result is of type default logical.
  34.  
  35.      If _t_a_r_g_e_t is absent, the result is true if _p_o_i_n_t_e_r is currently
  36.      associated with a target and false if it is not.
  37.  
  38.      If _t_a_r_g_e_t is present and is a target, the result is true if _p_o_i_n_t_e_r is
  39.      currently associated with _t_a_r_g_e_t and false if it is not.
  40.  
  41.      If _t_a_r_g_e_t is present and is a pointer, the result is true if both
  42.      _p_o_i_n_t_e_r and _t_a_r_g_e_t are currently associated with the same target, and
  43.      is false otherwise.
  44.  
  45.      If either _p_o_i_n_t_e_r or _t_a_r_g_e_t is disassociated, the result is false.
  46.  
  47.      If _p_o_i_n_t_e_r and _t_a_r_g_e_t are both dummy arguments, the result is
  48.      undefined.
  49.  
  50. EEXXAAMMPPLLEESS
  51.      Example 1:  AASSSSOOCCIIAATTEEDD ((CCUURRRREENNTT,, HHEEAADD)) is true if CCUURRRREENNTT points to
  52.      the target HHEEAADD.
  53.  
  54.      Example 2:  Consider the following statement:
  55.  
  56.           AA__PPAARRTT ==>> AA ((::NN))
  57.  
  58.      After the preceding statement is executed, the statement AASSSSOOCCIIAATTEEDD
  59.      ((AA__PPAARRTT,, AA)) is true if NN is equal to UUBBOOUUNNDD((AA,, DDIIMM == 11)).
  60.  
  61.      Example 3:  After the execution of the following statements,
  62.      AASSSSOOCCIIAATTEEDD((CCUURR,, TTOOPP)) is false:
  63.  
  64.           NULLIFY ((CCUURR));;  NNUULLLLIIFFYY ((TTOOPP))
  65.  
  66. SSEEEE AALLSSOO
  67.      _I_n_t_r_i_n_s_i_c _P_r_o_c_e_d_u_r_e_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l for the printed version of this
  68.      man page.
  69.